home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / shells / bashsrc.zoo / readme.st < prev    next >
Encoding:
Text File  |  1991-06-12  |  3.3 KB  |  59 lines
  1. GNU BASH - source archive
  2.  
  3. THIS PROGRAM REQUIRES THAT MiNT BE ACTIVE IN ORDER TO RUN.
  4. You need at least version 0.6 of MiNT, and a decent compiler with MiNT-aware
  5. libraries (read that as 'gcc with Eric Smith's MiNT library).
  6.  
  7. This is a port of bash, the GNU Bourne Again shell, to MiNT. It's essentially
  8. equivalent to the BSD version, right down to the (useless, on the ST) check
  9. for new mail. This means, in particular, that the backslash character ('\')
  10. is special, and must be duplicated to be passed to a program, i.e. type
  11. 'ls c:\\bin' instead of 'ls c:\bin'. For this reason, it's best used with
  12. utilities that allow forward slashes to separate directories.
  13.  
  14. The following ST specific features should be noted:
  15. (1) Searches for executable programs always consider the current directory
  16. first; this is a bug that I introduced in order to provide feature (2) easily.
  17. (2) Executable files with the "usual" extensions need not have those extensions
  18. added, i.e. if you type 'ls' then bash will look for 'ls', 'ls.ttp', 'ls.prg',
  19. and 'ls.tos' in that order in each directory on your path.
  20. (3) The ".bashrc" file is called "bash.rc" on the ST. Similarly, the .profile
  21. file is called "profile", the ".bash_profile" file is called "bash_pro",
  22. the ".bash_login" file is called "bash_log", and the ".bash_history" file
  23. is called "bash_his".
  24. (4) Only some of the "ulimit" options are supported under MiNT, namely
  25. the -d (malloc'd memory limit), -m (total memory limit), and -t (cpu
  26. time limit) options; note also that -d and -m mean slightly different
  27. things under MiNT than they do under BSD.
  28. (5) There's a bug (?) in the job control feature such that if you run
  29. bash from a program that doesn't know about job control, that program
  30. will be suspended when bash exits. Use "fg" (or whatever) to start
  31. the program again, or else never leave bash (half :-); I'm sure bash
  32. could be used as a replacement for the MiNT init.prg).
  33.  
  34. If you don't know bash already... sorry, but there isn't much in the way
  35. of docs. Get the source code (see below), and/or a good book on the Unix
  36. /bin/sh. There is (some) online help; just enter "help" on a line by
  37. itself. See also the "features" file.
  38.  
  39. This was taken from my local Sun network; it already had some diffs on it
  40. (probably most of the known bug fixes), and I used Eric Smith's original diffs
  41. as a starting point. The diffs included in this distribution are from the
  42. patched Sun version, so you will NOT need Eric's diffs to re-build this. I
  43. re-wrote the Makefile virtually from scratch; it's not terribly complete, but
  44. it does mean that the whole process is totally automatic. It was compiled
  45. under the MiNT-gcc library version 0.8; getting it to work with another
  46. compiler/library setup will probably prove impossible. Note also that I have
  47. the readline/history library (source included) installed as a standard library
  48. on my machine.
  49.  
  50. I will attempt to support this, but I don't have much time to do so, and
  51. I intend abandoning 1.05 and porting 1.07 or higher later this year (91).
  52.  
  53. Happy bashing!
  54.  
  55. 'Grave' Dave Gymer | Note that I don't have access to the net during
  56.  dpg@Cs.Nott.AC.UK | vacations, so don't be surprised if you get an
  57.                    | automatic message or no response from July to early
  58.                    | October. Sorry for any inconvenience.
  59.